Load

This parameter is a character string that specifies the name of a workspace, or a directory or text file containing APL source code, to be loaded when Dyalog starts.

If Load specifies a text file, 2 ⎕FIX is used to import the file contents and associate that file with each of the objects that have been fixed in the workspace.

If Load specifies a directory, Link is used to associate the directory with the active workspace and to import the code. For more information about Link, see https://dyalog.github.io/link/3.0/.

The Load parameter will normally be specified on the command line or in a Configuration file.

Having loaded the workspace, or fixed the code from the named file or directory, Dyalog executes the expression specified by the LX parameter if it is set. See LX.

If LX is not set, Dyalog checks whether or not the -x command line option was specified. If so, no further action is taken. See -x.

Otherwise, Dyalog executes an expression which is derived as follows.

If the value of Load is a directory, Dyalog will execute the expression:

       Run ,⊂<Load>

where <Load> is the value of the Load parameter.

If the value of Load is the name of a file, Dyalog determines whether or not the file is a workspace by its internal signature.

If the file is a workspace the expression to be executed is specified by its ⎕LX. See Latent Expression .

Otherwise, if the file extension is .aplf .aplc or .apln the expression is shown in the table below, where filename is the file name specified by the Load parameter without its extension.

File Extension	Type	Expression
.aplf	Function source code	filename 0⍴⊂''
.aplc	Class source code	filename.Run 0⍴⊂''
.apln	Namespace source code	filename.Run 0⍴⊂''

Notes:

• The Load parameter overrides a workspace name specified as the last item on the command line.
• The option to load APL source code from a text file applies only to the Unicode version and is not supported by the Classic version.
• The argument 0⍴⊂'' may change in a future version of Dyalog.
• Nothing is executed when code is loaded from source files that define operators (.aplo) or Interfaces (.apli).